<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>38.11. Zend_Service_StrikeIron: Bundled Services</title>
<link rel="stylesheet" href="dbstyle.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
<link rel="start" href="index.html" title="Programmer's Reference Guide">
<link rel="up" href="zend.service.html" title="Chapter 38. Zend_Service">
<link rel="prev" href="zend.service.strikeiron.html" title="38.10. Zend_Service_StrikeIron">
<link rel="next" href="zend.service.strikeiron.advanced-uses.html" title="38.12. Zend_Service_StrikeIron: Advanced Uses">
<link rel="chapter" href="introduction.html" title="Chapter 1. Introduction to Zend Framework">
<link rel="chapter" href="zend.acl.html" title="Chapter 2. Zend_Acl">
<link rel="chapter" href="zend.auth.html" title="Chapter 3. Zend_Auth">
<link rel="chapter" href="zend.cache.html" title="Chapter 4. Zend_Cache">
<link rel="chapter" href="zend.config.html" title="Chapter 5. Zend_Config">
<link rel="chapter" href="zend.console.getopt.html" title="Chapter 6. Zend_Console_Getopt">
<link rel="chapter" href="zend.controller.html" title="Chapter 7. Zend_Controller">
<link rel="chapter" href="zend.currency.html" title="Chapter 8. Zend_Currency">
<link rel="chapter" href="zend.date.html" title="Chapter 9. Zend_Date">
<link rel="chapter" href="zend.db.html" title="Chapter 10. Zend_Db">
<link rel="chapter" href="zend.debug.html" title="Chapter 11. Zend_Debug">
<link rel="chapter" href="zend.dojo.html" title="Chapter 12. Zend_Dojo">
<link rel="chapter" href="zend.dom.html" title="Chapter 13. Zend_Dom">
<link rel="chapter" href="zend.exception.html" title="Chapter 14. Zend_Exception">
<link rel="chapter" href="zend.feed.html" title="Chapter 15. Zend_Feed">
<link rel="chapter" href="zend.filter.html" title="Chapter 16. Zend_Filter">
<link rel="chapter" href="zend.form.html" title="Chapter 17. Zend_Form">
<link rel="chapter" href="zend.gdata.html" title="Chapter 18. Zend_Gdata">
<link rel="chapter" href="zend.http.html" title="Chapter 19. Zend_Http">
<link rel="chapter" href="zend.infocard.html" title="Chapter 20. Zend_InfoCard">
<link rel="chapter" href="zend.json.html" title="Chapter 21. Zend_Json">
<link rel="chapter" href="zend.layout.html" title="Chapter 22. Zend_Layout">
<link rel="chapter" href="zend.ldap.html" title="Chapter 23. Zend_Ldap">
<link rel="chapter" href="zend.loader.html" title="Chapter 24. Zend_Loader">
<link rel="chapter" href="zend.locale.html" title="Chapter 25. Zend_Locale">
<link rel="chapter" href="zend.log.html" title="Chapter 26. Zend_Log">
<link rel="chapter" href="zend.mail.html" title="Chapter 27. Zend_Mail">
<link rel="chapter" href="zend.measure.html" title="Chapter 28. Zend_Measure">
<link rel="chapter" href="zend.memory.html" title="Chapter 29. Zend_Memory">
<link rel="chapter" href="zend.mime.html" title="Chapter 30. Zend_Mime">
<link rel="chapter" href="zend.openid.html" title="Chapter 31. Zend_OpenId">
<link rel="chapter" href="zend.paginator.html" title="Chapter 32. Zend_Paginator">
<link rel="chapter" href="zend.pdf.html" title="Chapter 33. Zend_Pdf">
<link rel="chapter" href="zend.registry.html" title="Chapter 34. Zend_Registry">
<link rel="chapter" href="zend.rest.html" title="Chapter 35. Zend_Rest">
<link rel="chapter" href="zend.search.lucene.html" title="Chapter 36. Zend_Search_Lucene">
<link rel="chapter" href="zend.server.html" title="Chapter 37. Zend_Server">
<link rel="chapter" href="zend.service.html" title="Chapter 38. Zend_Service">
<link rel="chapter" href="zend.session.html" title="Chapter 39. Zend_Session">
<link rel="chapter" href="zend.soap.html" title="Chapter 40. Zend_Soap">
<link rel="chapter" href="zend.test.html" title="Chapter 41. Zend_Test">
<link rel="chapter" href="zend.text.html" title="Chapter 42. Zend_Text">
<link rel="chapter" href="zend.timesync.html" title="Chapter 43. Zend_TimeSync">
<link rel="chapter" href="zend.translate.html" title="Chapter 44. Zend_Translate">
<link rel="chapter" href="zend.uri.html" title="Chapter 45. Zend_Uri">
<link rel="chapter" href="zend.validate.html" title="Chapter 46. Zend_Validate">
<link rel="chapter" href="zend.version.html" title="Chapter 47. Zend_Version">
<link rel="chapter" href="zend.view.html" title="Chapter 48. Zend_View">
<link rel="chapter" href="zend.xmlrpc.html" title="Chapter 49. Zend_XmlRpc">
<link rel="appendix" href="requirements.html" title="Appendix A. Zend Framework Requirements">
<link rel="appendix" href="coding-standard.html" title="Appendix B. Zend Framework Coding Standard for PHP">
<link rel="appendix" href="copyrights.html" title="Appendix C. Copyright Information">
<link rel="index" href="the.index.html" title="Index">
<link rel="subsection" href="zend.service.strikeiron.bundled-services.html#zend.service.strikeiron.bundled-services.zip-code-information" title="38.11.1. ZIP Code Information">
<link rel="subsection" href="zend.service.strikeiron.bundled-services.html#zend.service.strikeiron.bundled-services.us-address-verification" title="38.11.2. U.S. Address Verification">
<link rel="subsection" href="zend.service.strikeiron.bundled-services.html#zend.service.strikeiron.bundled-services.sales-use-tax-basic" title="38.11.3. Sales &amp; Use Tax Basic">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader"><table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">38.11. Zend_Service_StrikeIron: Bundled Services</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="zend.service.strikeiron.html">Prev</a> </td>
<th width="60%" align="center">Chapter 38. Zend_Service</th>
<td width="20%" align="right"> <a accesskey="n" href="zend.service.strikeiron.advanced-uses.html">Next</a>
</td>
</tr>
</table></div>
<div class="sect1" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="zend.service.strikeiron.bundled-services"></a>38.11. Zend_Service_StrikeIron: Bundled Services</h2></div></div></div>
<p>
      Zend_Service_StrikeIron comes with wrapper classes for three popular StrikeIron services.
    </p>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="zend.service.strikeiron.bundled-services.zip-code-information"></a>38.11.1. ZIP Code Information</h3></div></div></div>
<p>
        <code class="code">Zend_Service_StrikeIron_ZipCodeInfo</code> provides a client for StrikeIron's
        Zip Code Information Service.  For more information on this service, visit these
        StrikeIron resources:

        </p>
<div class="itemizedlist"><ul type="disc">
<li><p>
              <a href="http://www.strikeiron.com/ProductDetail.aspx?p=267" target="_top">Zip Code Information Service Page</a>
            </p></li>
<li><p>
              <a href="http://sdpws.strikeiron.com/zf1.StrikeIron/sdpZIPCodeInfo?WSDL" target="_top">Zip Code Information Service WSDL</a>
            </p></li>
</ul></div>
<p>

        The service contains a <code class="code">getZipCode()</code> method that will retrieve information
        about a United States ZIP code or Canadian postal code:

        </p>
<pre class="programlisting">&lt;?php
require_once 'Zend/Service/StrikeIron.php';

$strikeIron = new Zend_Service_StrikeIron(array('username' =&gt; 'your-username',
                                                'password' =&gt; 'your-password'));

// Get a client for the Zip Code Information service
$zipInfo = $strikeIron-&gt;getService(array('class' =&gt; 'ZipCodeInfo'));

// Get the Zip information for 95014
$response = $zipInfo-&gt;getZipCode(array('ZipCode' =&gt; 95014));
$zips = $response-&gt;serviceResult;

// Display the results
if ($zips-&gt;count == 0) {
    echo 'No results found';
} else {
    // a result with one single zip code is returned as an object,
    // not an array with one element as one might expect.
    if (! is_array($zips-&gt;zipCodes)) {
        $zips-&gt;zipCodes = array($zips-&gt;zipCodes);
    }

    // print all of the possible results
    foreach ($zips-&gt;zipCodes as $z) {
        $info = $z-&gt;zipCodeInfo;

        // show all properties
        print_r($info);

        // or just the city name
        echo $info-&gt;preferredCityName;
    }
}

// Detailed status information
// http://www.strikeiron.com/exampledata/StrikeIronZipCodeInformation_v3.pdf
$status = $response-&gt;serviceStatus;
        </pre>
<p>
      </p>
</div>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="zend.service.strikeiron.bundled-services.us-address-verification"></a>38.11.2. U.S. Address Verification</h3></div></div></div>
<p>
        <code class="code">Zend_Service_StrikeIron_USAddressVerification</code> provides a client for
        StrikeIron's U.S. Address Verification Service.  For more information on this
        service, visit these StrikeIron resources:

        </p>
<div class="itemizedlist"><ul type="disc">
<li><p>
              <a href="http://www.strikeiron.com/ProductDetail.aspx?p=198" target="_top">U.S. Address Verification Service Page</a>
            </p></li>
<li><p>
              <a href="http://ws.strikeiron.com/zf1.StrikeIron/USAddressVerification4_0?WSDL" target="_top">U.S. Address Verification Service WSDL</a>
            </p></li>
</ul></div>
<p>
      </p>
<p>
        The service contains a <code class="code">verifyAddressUSA()</code> method that will verify
        an address in the United States:

        </p>
<pre class="programlisting">&lt;?php
require_once 'Zend/Service/StrikeIron.php';

$strikeIron = new Zend_Service_StrikeIron(array('username' =&gt; 'your-username',
                                                'password' =&gt; 'your-password'));

// Get a client for the Zip Code Information service
$verifier = $strikeIron-&gt;getService(array('class' =&gt; 'USAddressVerification'));

// Address to verify.  Not all fields are required but
// supply as many as possible for the best results.
$address = array('firm'           =&gt; 'Zend Technologies',
                 'addressLine1'   =&gt; '19200 Stevens Creek Blvd',
                 'addressLine2'   =&gt; '',
                 'city_state_zip' =&gt; 'Cupertino CA 95014');

// Verify the address
$result = $verifier-&gt;verifyAddressUSA($address);

// Display the results
if ($result-&gt;addressErrorNumber != 0) {
    echo $result-&gt;addressErrorNumber;
    echo $result-&gt;addressErrorMessage;
} else {
    // show all properties
    print_r($result);

    // or just the firm name
    echo $result-&gt;firm;

    // valid address?
    $valid = ($result-&gt;valid == 'VALID');
}
        </pre>
<p>
      </p>
</div>
<div class="sect2" lang="en">
<div class="titlepage"><div><div><h3 class="title">
<a name="zend.service.strikeiron.bundled-services.sales-use-tax-basic"></a>38.11.3. Sales &amp; Use Tax Basic</h3></div></div></div>
<p>
        <code class="code">Zend_Service_StrikeIron_SalesUseTaxBasic</code> provides a client for
        StrikeIron's Sales &amp; Use Tax Basic service.  For more information on this
        service, visit these StrikeIron resources:

        </p>
<div class="itemizedlist"><ul type="disc">
<li><p>
              <a href="http://www.strikeiron.com/ProductDetail.aspx?p=351" target="_top">Sales &amp; Use Tax Basic Service Page</a>
            </p></li>
<li><p>
              <a href="http://ws.strikeiron.com/zf1.StrikeIron/taxdatabasic4?WSDL" target="_top">Sales &amp; Use Tax Basic Service WSDL</a>
            </p></li>
</ul></div>
<p>
      </p>
<p>
        The service contains two methods, <code class="code">getTaxRateUSA()</code> and <code class="code">getTaxRateCanada()</code>,
        that will retrieve sales and use tax data for the United States and Canada, respectively.

        </p>
<pre class="programlisting">&lt;?php
require_once 'Zend/Service/StrikeIron.php';

$strikeIron = new Zend_Service_StrikeIron(array('username' =&gt; 'your-username',
                                                'password' =&gt; 'your-password'));

// Get a client for the Sales &amp; Use Tax Basic service
$taxBasic = $strikeIron-&gt;getService(array('class' =&gt; 'SalesUseTaxBasic'));

// Query tax rate for Ontario, Canada
$rateInfo = $taxBasic-&gt;getTaxRateCanada(array('province' =&gt; 'foo'));
print_r($rateInfo);               // show all properties
echo $rateInfo-&gt;GST;              // or just the GST (Goods &amp; Services Tax)

// Query tax rate for Cupertino, CA USA
$rateInfo = $taxBasic-&gt;getTaxRateUS(array('zip_code' =&gt; 95014));
print_r($rateInfo);               // show all properties
echo $rateInfo-&gt;state_sales_tax;  // or just the state sales tax
        </pre>
<p>
      </p>
</div>
</div>
<div class="navfooter"><table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="zend.service.strikeiron.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="zend.service.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="zend.service.strikeiron.advanced-uses.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">38.10. Zend_Service_StrikeIron </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> 38.12. Zend_Service_StrikeIron: Advanced Uses</td>
</tr>
</table></div>
<div class="revinfo"></div>
</body>
</html>
